home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / prog / langwn23.zip / READ.ME < prev    next >
Text File  |  1993-03-25  |  5KB  |  117 lines
  1. ------------------------------------------------------------------------------
  2. LangWin Version 2.3 (C) Copyright Allen L. Lang, 1993     ALL RIGHTS RESERVED
  3. -----------------------------------------------------------------------------
  4.  
  5. LangWin is a QuickBASIC program development toolkit. It contains a library of 
  6. functions and subroutines that can be used to easily create standard Graphical 
  7. User Interface (GUI) features in your compiled text-mode QuickBASIC or BASIC 
  8. PDS programs (sorry, LangWin cannot be used with the QBASIC interpreter in DOS 
  9. 5.0). 
  10.  
  11. GUI features supported include: opening/closing windows with drop-shadows, 
  12. scrollable text, push buttons, click boxes, dialog boxes, editable input 
  13. fields, etc. LangWin's GUI routines support both mouse and keyboard input. 
  14. Windows created by LangWin can be moved and resized (mouse only). LangWin also 
  15. contains stand-alone routines that can be used to add mouse support to your 
  16. QuickBASIC programs that do not use LangWin. Mouse features include: 
  17. initialization, get/set position, get button status, hide/show cursor, set 
  18. horizontal/vertical limits, etc. Finally, LangWin has several functions that 
  19. allow you to get the default drive and directory, change the default 
  20. drive/directory, and extract all file/sub-directory names from the current 
  21. directory. 
  22.  
  23.  
  24.  
  25. The download you received contains the following files:
  26. -------------------------------------------------------
  27.  
  28. LANGWIN.DOC    - LangWin User's Guide
  29. LANGWIN.BI     - LangWin's include file
  30. LANGWIN.LIB    - QuickBASIC LIB for linking |___
  31. LANGWIN.QLB    - QuickBASIC quick library   |   | you will probably only need 
  32. LANGWINP.LIB   - PDS LIB for linking   |________| one of these pairs. 
  33. LANGWINP.QLB   - PDS quick library     |
  34. SAMPLE01.BAS   - sample source code using LangWin's routines
  35. SAMPLE02.BAS   - sample source code using LangWin's routines
  36. SAMPLE03.BAS   - sample source code using LangWin's routines
  37. SAMPLE04.BAS   - sample source code using LangWin's routines
  38. SAMPLE05.BAS   - sample source code using LangWin's routines
  39. WINHELP.BAS    - online help text that can be loaded into the QB environment
  40. WINCOLOR.EXE   - program to assist in selecting color combinations for windows
  41. FINDFILE.EXE   - generic find file program (check out the options) developed
  42.                  with LangWin's GUI toolkit
  43.  
  44.  
  45.  
  46. NOTE: both QuickBASIC and PDS libraries (LIB & QLB) are included. 
  47. Unless you have both compilers, you can save space by deleting the pair
  48. of files you don't need. 
  49.  
  50.  
  51.  
  52. Getting Started
  53. ---------------
  54. If you haven't already done so, copy the above files to your hard disk. 
  55.  
  56. I've found there are two categories of computer users: those that read the 
  57. documentation first then dig into the application, and those that go right 
  58. for the application without examining the doc.
  59.  
  60. If you are the type that likes to read the doc first:
  61.         * Start with LANGWIN.DOC. It describes all of LangWin's functions and 
  62.           features. Use your own browser to read it, or enter: 
  63.                 type langwin.doc | more
  64.         * Run QB and load the WINHELP module. Hit F2 to see a list of all
  65.           LangWin's routines. Select a routine to see its purpose, parameters,
  66.           return codes, notes for usage, etc. You can keep the WINHELP module
  67.           in the QB environment while doing development to have instant access
  68.           to reference information on all LangWin routines.
  69.         * Load the SAMPLE programs and run them to see what they do, and how 
  70.           they use LangWin's features.
  71.         * Run WINCOLOR to help you pick color combinations for your windows.
  72.         
  73.  
  74. If you like to jump right in, or want to get a quick start, then change
  75. to the directory with LangWin's routines and enter one of the following:
  76.  
  77.         qb /ah /L langwin         (for QuickBASIC) 
  78. or
  79.         qbx /ah /L langwinp       (for PDS)         
  80.  
  81. This will load your QuickBASIC (or PDS) environment,
  82. along with the LangWin quick library.
  83.  
  84.         select File, then Open Program ...
  85.         select SAMPLE01.BAS
  86.         then run the program
  87.  
  88. You'll see some examples of what can be done with LangWin.
  89. You can examine the code and then try the other sample programs.
  90.  
  91. I STRONGLY recommend that you take the time to read all of LANGWIN.DOC, scan 
  92. all members in WINHELP.BAS, and review all sample programs. This will take an 
  93. investment of your time. However, you'll gain a better understanding of 
  94. LangWin's functions, and be able to take advantage of all its features to 
  95. produce programs with a professional quality GUI. 
  96.  
  97. I've included a free "file find" utility (EXE only) developed with LangWin. 
  98. This generic utility can be used to find all names on a given drive that match 
  99. a given file specification (including the use of ? and * wildcards). There's 
  100. also an "option" window where you can specify additional criteria for 
  101. selecting the file (like attribute bits, size, date, and time). This utility 
  102. is similar to those found in commercial packages. It illustrates a practical 
  103. example of the professional looking programs that can be developed with 
  104. LangWin's GUI toolkit. Hope you like it! 
  105.  
  106.  
  107.  
  108.  
  109.            Allen Lang
  110.            121 Windsor Commons
  111.            Cranbury, NJ 08512
  112.  
  113.            Prodigy ID: KJNX76A
  114.  
  115.            3/20/93   
  116.  
  117.